home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / ul_dl11.zip / UL-DL.DOC < prev    next >
Text File  |  1992-01-05  |  8KB  |  264 lines
  1.                       Upload/Download Files List v1.1
  2.                       Copyright 1992, by Mark Langdon
  3.                        
  4.                           For PCBoard 14.5a BBS's             
  5.  
  6.  
  7.  
  8.         :::::: NOTE CONFIGURATION FILE CHANGE IN THIS RELEASE ::::::
  9.   
  10.  There is a MINOR change to the .CFG configuration file needed to use this
  11. release of UL-DL.EXE. I neglected to provide a way for the BBS sysop to 
  12. insert THEIR Bbs name to the DLFILES.TXT and ULFILES.TXT files. Oooops!
  13. All you need to do it add a line to your UL-DL.CFG file (or whatever you
  14. called it) as the FIRST line in the file. This MUST be on the FIRST line.
  15. There is an example of this .cfg file below under SET-UP.
  16.                                                   ------
  17.                                                   
  18.         ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. INTRODUCTION
  27. ------------
  28.  
  29.  Myself being one who does a lot of uploading and downloading from BBS's, I
  30. found that I lost track of what files I uploaded or downloaded to what BBS's.
  31. I wrote this small program for PCBoard BBs's so the user can create and 
  32. download a list of all files that he/she has transferred to the BBS.
  33.  
  34.  
  35. LICENSE AGREEMENT
  36. -----------------
  37.  
  38.  This program is being distributed as "FreeWare". There is no charge of any
  39. kind to use this software. The only requirement is that ALL files within
  40. this .ZIP file MUST be TRANSFERRED together.             ---             
  41.  
  42.  
  43. DISCLAIMER
  44. ----------
  45.  
  46.  In no way will I, the author of this program, be liable to you for any
  47. damages including any lost data, damaged equiptment, or any other damages
  48. as a result of using this program.
  49.  
  50.  
  51. FILES LISTING 
  52. -------------
  53.  
  54.  CLEANLOG.EXE ....... Cleans your DOWNLOAD.TXT file of possible errors.
  55.  FILE_ID.DIZ ........ This program description. (please keep with .zip file)
  56.  FLAGFILE.TXT ....... Will cause PCB to automatically FALG the newly created
  57.                       file listing for download.
  58.  UDLIST ............. Example of batch file to run this door.
  59.  UL-DL.CFG .......... Configuration file for the program.
  60.  UL-DL.DOC .......... The docs, your read'n it!
  61.  UL-DL.EXE .......... The main program file.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. HOW IT WORKS
  70. ------------
  71.  
  72.  This program takes advantage of the special features of PCBoard 14.5a.
  73. Here's how it works.  This program is set up as a SHELLED door in PCBoard.
  74. You create a batch file, just like any other door, but you should also add
  75. the command to your PCBoard main menu screen (BRDM). It is a shell so when 
  76. run, it will not give the user a message saying, "Loading xxxxx door". 
  77. Therefore it looks like any other command issued from PCBoard.
  78.  When a user enters the command, (the command being whatever YOU name the
  79. batch file), this program looks for your DOWNLOAD.TXT file, then creates
  80. 2 files - ULFILES.TXT, a list of files that the user has uploaded to your BBS,
  81. and DLFILES.TXT, a list of files that the user has downloaded from your BBS.
  82. That is basically all this program itself does. The rest of the process is 
  83. handled in the batch file (see below).
  84. NOTE:: The larger your DOWNLOAD.TXT file is, the longer it will take this 
  85.        program to process it.
  86.  
  87.  
  88.  
  89.  
  90.  
  91. SET-UP
  92. ------
  93.  
  94.  The command line usage for this program is - "UL-DL.EXE UL-DL.CFG"
  95.                                                   |         |
  96.                                            Program Name  Config. file name
  97.    
  98.    .CFG FILE
  99.    ---------
  100.     The configuration file can be whatever you name it. The file consists
  101.    of only two lines of text. The first line is Your BBS name, the second
  102.    line is the name & location of your PCBOARD.SYS file. The third line is
  103.    the name & location of your DOWNLOAD.TXT file. 
  104.  
  105.              example- Your BBS Name Here
  106.                       D:\PCB\PCBoard.SYS
  107.                       D:\PCB\DOWNLOAD.TXT
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.   
  135.  The largest task when setting up this program is the batch file that will
  136. run the door. Below is an example of the batch file and it's explanation -
  137.  
  138.  
  139. D:                                     ;Change to Drive C:
  140. cd D:\PCB\ULDL                         ;Change to dir. where you install 
  141.                         this program.
  142. PROECHO 2 ~Creating File Transfer Lists. Please Wait........... (see below)
  143. ul-dl ul-dl.cfg                        ;Invoke this program
  144. PROECHO 2 ~Now Zipping Files For Download. Please Wait......... (see below)
  145. PKZIP UL-DL DLFILES.TXT ULFILES.TXT    ;Zip the new files created.
  146. DEL DLFILES.TXT                        ;Delete download file report. (not
  147.                                         used after it has been zipped)
  148. DEL ULFILES.TXT                        ;Delete upload file report.   (not
  149.                                         used after it has been zipped)
  150. COPY UL-DL.ZIP D:\PCB\UPLOADS\UP       ;Copy the new .zip file to a VALID
  151.                                         download dir specified in your
  152.                                         PCBSETUP.  (I recommend your main
  153.                                         Upload dir.)
  154. DEL UL-DL.ZIP                          ;Delete old .zip file 
  155. COPY FLAGFILE.TXT D:\PCB\PCBSTUFF.KBD  ;Included in this .zip file is the file
  156.                         FALGFILE.TXT. This contains the PCB
  157.                         command, "FLAG", and the filename that
  158.                         you gave the zipped file, (in this 
  159.                         example the filename is UL-DL.ZIP),
  160.                         separated by a colon (;). This is 
  161.                         needed if you want PCBoard to auto-
  162.                         maticly FLAG the file for download
  163.                         upon returning from the door.
  164.                          Just copy the contents of this file
  165.                         to your BBS directory as filename
  166.                         PCBSTUFF.KBD. PCBoard will also delete
  167.                         this file after it carries out the 
  168.                         FLAG operation.
  169. CD D:\PCB                               ;Change back to your BBS directory.
  170. EXIT                                    ;EXIT the shell, back to PCBoard.
  171.  
  172. NOTE: Just remember to change the path specifications in the above example,
  173.       to YOUR computer's configuration.
  174.  
  175.  Lines 2 and 5, referenced above, are lines of text sent out the modem to let
  176. the user know what is going on. THIS IS OPTIONAL. I used the program -
  177. PROECHO.EXE, which is a public domain program available on many BBS's,
  178. to send text out the modem. Another similar program which will work fine is-
  179. SENDCOM.EXE.                      
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. CLEANLOG.EXE
  202. ------------
  203.  
  204.  I included this program because I found that your DOWNLOAD.TXT file sometimes
  205. records a blank line. This will cause the UD-LD.EXE program to mis-read the
  206. download.txt file, and result in incorrect transfer reports.
  207.  This program will not harm your download.txt file at all, so I recommend
  208. running it before you use UL-DL.EXE. (It will also prevent any other utilities
  209. from mis-reading the download.txt file in the future).
  210.  To run this program your download.txt MUST be in the same directory as this
  211. program. When run, it will create a new download.txt file`called DOWNLOAD.NEW.
  212. Then just  delete your old  download.txt file, and rename download.new as 
  213. download.txt.
  214. (keep in mind that, as with the UL-DL.EXE program, the speed of this program
  215. depends on the size of your download.txt. Myself with a 15 ms fast hard
  216. drive, and 80286 CPU, it takes a 200k file about 1.25 min. to process).
  217.  
  218.  
  219. SUPPORT
  220. -------
  221.  
  222.  If you run into any problems with this program, or perhaps would like to
  223. comment about it, I can be reached, as the Sysop, at - 
  224.  
  225.               ********************************************
  226.               *          Mark's "Unknwon" BBS            *
  227.               *              Agawam, Ma.                 *
  228.               *            (413) 786-9136                *
  229.               *                                          *
  230.               *     On-Line 24 hrs/day, 7-days/week      *
  231.               *        Supporting 1200/2400 bd.          *
  232.               *    No Parity, 8 data bits, 1 stop bit    *
  233.               ********************************************
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.